home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / forms.arc / FORMS.DOC < prev    next >
Encoding:
Text File  |  1985-03-10  |  18.5 KB  |  662 lines
  1.             
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                      F O R M S
  19.  
  20.  
  21.                                  Reference Manual
  22.  
  23.                                     Version 1.0
  24.  
  25.  
  26.                                     March 1985
  27.  
  28.  
  29.                                 MaeDae Enterprises
  30.                                 1826 Wren
  31.                                 League City, TX 77573
  32.  
  33.  
  34.                      (c) Copyright 1985 by MaeDae Enterprises
  35.                                 All Rights Reserved
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                                       PREFACE
  73.  
  74.  
  75.          FORMS is distributed under the "Shareware" concept.  Feel free
  76.          to pass copies to your friends and PC users groups.  This program
  77.          may be uplinked to bulletin boards provided this documentation 
  78.          file is included.  YOU MAY NOT SELL FORMS!
  79.  
  80.          A contribution of $30.00 is suggested if FORMS proves useful to 
  81.          you.  This contribution entitles you to:
  82.  
  83.                     1.  A copy of the latest version of FORMS
  84.                     2.  A complete users manual
  85.                     3.  Notification of future updates of FORMS
  86.                     4.  Notification of other software products developed
  87.                         by MaeDae Enterprises
  88.  
  89.          Send all contributions and inquires to:
  90.                    
  91.                     MaeDae Enterprises
  92.                     1826 Wren
  93.                     League City, TX 77573
  94.  
  95.  
  96.  
  97.  
  98.  
  99.          Disclaimer:
  100.  
  101.          MaeDae Enterprises makes no claims for or offers no warranties of 
  102.          any sort with FORMS.  MaeDae Enterprises assumes NO responsibility 
  103.          for any sort of damage resulting from the apparent or actual use 
  104.          of FORMS (mental or physical).  MaeDae Enterprises DOES want to 
  105.          know of any problems users have with FORMS and will fix any 
  106.          "bugs" found by our users.  We will also try to incorporate 
  107.          changes and enhancements based on our users suggestions.
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                          i
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.                                  TABLE OF CONTENTS
  139.  
  140.  
  141.  
  142.                            1.  OVERVIEW
  143.  
  144.                            2.  GETTING STARTED
  145.  
  146.                            3.  KEY DESCRIPTIONS
  147.  
  148.                            4.  SUGGESTIONS/EXAMPLE USAGE
  149.  
  150.                            5.  NOTES ON FORMS
  151.           
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                         ii
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.                                      OVERVIEW
  205.  
  206.  
  207.          FORMS is a form-generating program that allows you, the user, 
  208.          to generate master forms tailored to your individual needs.
  209.          FORMS allows you to create or revise a master form or a 
  210.          completed (filled out) form.  A master form can be altered only
  211.          if you are operating in the "create or revise a master form"
  212.          mode.
  213.  
  214.          Master and completed forms can be stored as well as printed.
  215.          Once a master form has been created and saved, it can be 
  216.          recalled an unlimited number of times to be filled out and then
  217.          stored as a completed form.
  218.  
  219.          FORMS supports IBM (Epson) compatible printers as well as Daisy
  220.          wheel printers, however only Epson and Epson compatibles (Gemini
  221.          10X for example) can take advantage of the compressed mode used
  222.          by FORMS when printing out larger forms.
  223.  
  224.          FORMS requires an IBM PC or IBM PC compatible with at least 256K
  225.          of RAM.  Direct screen memory access is used to provide high 
  226.          speed screen updates.  This may make FORMS unusable on some
  227.          "not too close" IBM PC compatibles.  If after loading FORMS, 
  228.          you see only text, no borders, then you have a compatibility
  229.          problem.  If you provide MaeDae Enterprises with information 
  230.          on your screen memory starting address, MaeDae Enterprises
  231.          will try to include your display adapter particulars in the
  232.          FORMS defaults.  IBM monochrome, color, and enhanced graphics
  233.          adapters are known to work with FORMS.
  234.             
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                            1
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.                                   GETTING STARTED
  271.  
  272.  
  273.          Everything has a beginning.  The ballerina begins by sticking 
  274.          her foot into her slipper, the college professor by finding his
  275.          box of multicolored chalk, and you'll begin by loading DOS into
  276.          your computer.  If you are an experienced computer person then
  277.          type FORMS and skip to the description of the menu items.
  278.  
  279.          However, if you're like the Mae of MaeDae Enterprises (who just
  280.          happens to be the one writing this section), then you'll need
  281.          all the help you can get.
  282.  
  283.          So find the diskette that has your DOS on it.  After loading 
  284.          DOS, type FORMS and press enter.  A wonderful display written by
  285.          the Dae of MaeDae will come up (my husband really spent some
  286.          time on this so please appreciate it)!
  287.  
  288.          At this point, some nice to know information will come up. 
  289.          Basically, if you are this far along your computer has enough
  290.          memory to run FORMS.  Press any key.  TA-DA the MAIN MENU.
  291.          The Main Menu options with descriptions are below.
  292.  
  293.                  1.  Create/Revise Master Form:  This option allows you
  294.                      to create a new master form or revise an existing
  295.                      one.  You have the capability to designate the form
  296.                      size (maximum size is 86 lines by 130 columns), 
  297.                      adding (or deleting) a border and drawing horizontal
  298.                      or vertical lines (diagonal lines are not possible).
  299.                      The cursor control keys are enabled, allowing you to
  300.                      "walk around" a newly created form.
  301.                  
  302.                  2.  Complete a Master Form:  With this option, you can 
  303.                      retrieve, then complete a copy of a master form.
  304.                      Text added to the original master form can be 
  305.                      manipulated, however, any text which is part of the
  306.                      master form can't be changed.
  307.           
  308.                  3.  Revise Completed Form:  Here you can recall a
  309.                      completed form for revision.  This option is the
  310.                      same as option two, except you aren't starting with
  311.                      with the "clean slate" of a master form.  You have
  312.                      complete freedom to revise any portion of the form
  313.                      except for the master form outline.
  314.                      
  315.                  4.  Print a Form:  This option gives you full access to
  316.                      the computer directories and drives to allow you
  317.                      flexibility in searching out and printing forms. If
  318.                      you have an Epson or Epson compatible, then you can
  319.                      take advantage of the compressed print format for
  320.                      larger forms.
  321.  
  322.                  5.  Utilities:  This section lets advanced users really 
  323.                      "play" with this package.  You will be able to
  324.                      manipulate forms -- erase, copy, rename, and even 
  325.                      export a form to a standard ASCII DOS file.
  326.                       
  327.                                          2
  328.                       
  329.                        
  330.  
  331.                          
  332.                         
  333.                        
  334.                         
  335.                            
  336.                  6.  General Information:  For those of you who will just
  337.                      have to run FORMS before reading the documentation,
  338.                      here is a short overview.
  339.                        
  340.                  7.  Exit to DOS:  All good things must come to an end.
  341.                      Choose this option if you want to leave FORMS and
  342.                      return to DOS.
  343.                      
  344.                       
  345.                        
  346.                    
  347.                      
  348.                        
  349.                  NOTE:  Once a form size has been selected (option 1),       
  350.                  it cannot be changed.    
  351.                       
  352.                       
  353.                        
  354.                       
  355.                       
  356.                     
  357.                    
  358.                        
  359.                      
  360.                        
  361.                      
  362.                    
  363.                      
  364.                     
  365.                     
  366.                      
  367.                      
  368.                     
  369.                     
  370.                    
  371.                    
  372.                    
  373.                      
  374.                       
  375.                      
  376.                        
  377.                     
  378.                     
  379.                  
  380.                      
  381.                     
  382.                       
  383.                     
  384.                      
  385.                     
  386.                      
  387.                   
  388.                      
  389.                     
  390.                      
  391.                      
  392.  
  393.                                          3
  394.                       
  395.                        
  396.                           
  397.             
  398.  
  399.  
  400.  
  401.  
  402.                                  KEY DESCRIPTIONS
  403.  
  404.  
  405.          Generating a master form consists of determining form dimensions,
  406.          drawing lines, and adding appropriate text.  FORMS defines the
  407.          numeric keypad keys, the keyboard keys, and function keys to make
  408.          this task easy.
  409.  
  410.          KEYPAD KEYS:  With the exception of the insert and delete keys, 
  411.          all keypad keys are non-destructive, that is, the character under
  412.          the cursor is not changed.
  413.  
  414.            left arrow - move cursor one space left
  415.            right arrow - move cursor one space right
  416.            up arrow - move cursor up one line 
  417.            down arrow - move cursor down one line
  418.            page up - move screen up one page (24 lines) within form
  419.            page down - move screen down one page within form
  420.            home - move screen to upper left portion of form
  421.            end - move screen to lower left portion of form
  422.            insert - inserts desired number of spaces at the cursor while
  423.                     moving rest of line right
  424.            delete - deletes character under cursor and moves rest of line
  425.                     to left to fill in space   
  426.  
  427.          FUNCTION KEYS:  These keys perform different functions depending
  428.          on whether you are working on a master form or a completed form.
  429.  
  430.           Master Form                                   Completed Form  
  431.           -----------                                   --------------
  432.          F1  Help                                          F1  Help 
  433.          F3  Draw Border                                   F10 Exit
  434.          F4  Erase Border
  435.          F5  Draw Line
  436.          F6  Erase Line
  437.          F10 Exit
  438.  
  439.          Note:  For F5 and F6 position the cursor at the beginning point 
  440.          and press the function key once.  Then position cursor at the 
  441.          ending point and press the function key again.  F5 and F6 can be
  442.          used for either vertical or horizontal line drawing/erasing.
  443.  
  444.          KEYBOARD KEYS:  All letters and numbers are entered as you 
  445.          normally would from the keyboard.  The special keyboard keys are:
  446.  
  447.            control right arrow (hold down Ctrl and press keypad right 
  448.              arrow) - move cursor to right side of form
  449.            control left arrow - move cursor to left side of form
  450.            return - move one line down, start of line
  451.            backspace (keyboard left arrow) - move cursor one position to
  452.              the left along with the rest of line
  453.  
  454.            Only in Master Form mode:
  455.              Alternate I (hold down Alt and press I) - insert line
  456.              Alternate D - delete line
  457.  
  458.  
  459.                                          4
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.                              SUGGESTIONS/EXAMPLE USAGE
  469.  
  470.  
  471.  
  472.          STEPS FOR EXAMPLE:  Creating a form named TEMP.
  473.  
  474.  
  475.          1.  Bring up FORMS.
  476.          2.  Press any key to go from the FORMS logo to the Main Menu.
  477.          3.  Select 1 for Create/Revise Master Form.  The screen will
  478.              clear and you will be presented with a menu of all the
  479.              existing master forms.
  480.          4.  Type TEMP and press enter.  A menu will appear asking you
  481.              to define the form size.
  482.          5.  Select 3 for a 40 line by 80 column form.  You are now in
  483.              the edit mode for a master form.
  484.          6.  Press F3.  A border should appear around the entire form.
  485.              Notice that the bottom of the form is missing.  We are
  486.              only looking at the 1st 24 lines of a 40 line form.
  487.          7.  Press PgDn.  The rest of the form will now appear.
  488.          8.  Press F5 for a line.  Move the cursor to the right side of
  489.              the form by pressing Ctrl and the keypad right arrow.  Press
  490.              F5 again.  We have just drawn a horizontal line on line 17 
  491.              of our form.  Don't worry about the "-" in column 1 of the 
  492.              form overwritting part of the border.  Just press F3 once
  493.              more to restore the border.
  494.          9.  Be creative.  Walk around on the form and type in text,
  495.              make vertical lines, or anything you desire.  Refer to this
  496.              manual or press F1 (Help) then select 4 for more information
  497.              on the key functions.
  498.          10. Press F10 (Exit).  We are ready to save our masterpiece.
  499.          11. Select 7 (Save and Exit).  When asked for the file name type
  500.              TEMP and press enter.  TEMP will now be saved.
  501.          12. Select 2 (Complete a Master Form).  You will see a directory
  502.              of master forms displayed.  Type TEMP and press enter.
  503.          13. You are now in the "complete a form" mode.  Walk around on 
  504.              the screen and "fill out" the form you generated earlier.  
  505.              Notice how the outline of the master form is protected from 
  506.              erasure.
  507.          14. Press F10 (Exit).  We have now completed a master form.
  508.          15. Select 7 (Save and Exit).  When asked for the file name type
  509.              TEMP01 and press enter.  We have just saved our first 
  510.              completed form (notice the 01 we added after TEMP in the file
  511.              name, this allows easy reference later).
  512.          16. We are now back at the Main Menu.  From here you can print 
  513.              TEMP or call it in for further revision.
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                          5
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.            
  534.                                   NOTES ON FORMS
  535.  
  536.  
  537.  
  538.          A mixture of information relating to FORMS is listed below.
  539.          These items didn't seem to fit into any of the other sections
  540.          but need to be passed on to you.
  541.  
  542.          GENERAL:  
  543.  
  544.          1.  FORMS was written in Borland's Turbo Pascal.  The source 
  545.          code consists of 4000 lines of code.
  546.  
  547.          2.  All screen manipulation, including windowing, is handled by
  548.          writing directly to the screen memory.  This provides extremely
  549.          fast screen updates and allows high speed scrolling of text on
  550.          the screen.  Checks are performed to determine whether your 
  551.          system is color or monochrome and the corresponding section of
  552.          memory is used. 
  553.  
  554.          3.  FORMS is a "Shareware" software package.  Please provide
  555.          suggestions for improvement and also a contribution of $30 to 
  556.          show us that our efforts are not in vain.  FORMS will continue
  557.          to improve as long as people suggest improvements and contribute
  558.          toward its development.
  559.  
  560.          PRINTING:
  561.  
  562.          1.  Most IBM PCs have the printer connected on LPT1 (the first
  563.          parallel printer port).  The Print Menu allows you to select 
  564.          LPT1 as the default printer port.  If you select it, then FORMS
  565.          will do a check to ensure that the printer is turned on and 
  566.          on-line prior to trying to print.  This will allow you to
  567.          correct most problems prior to the start of printing.
  568.  
  569.          2.  If you have chosen an Epson compatible printer then FORMS
  570.          will use compressed print and adjust the line spacing as 
  571.          necessary to allow your form to fit on a single sheet of paper.
  572.  
  573.          SAVING:
  574.  
  575.          1.  Retyping the file name is required only if you are creating
  576.          a new master form or filling out a master form.  If you are
  577.          editing an existing form then press enter when asked for file
  578.          name and the original file name will be used.
  579.  
  580.          2.  Before saving, a check is done to ensure sufficient space is
  581.          left on the diskette and that the file doesn't already exist.  If
  582.          a problem occurs, FORMS will prompt you for the necessary action.
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                          6
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.          DEFAULT DRIVE:
  599.  
  600.          FORMS allows you to change the default drive so that you can have
  601.          full access to all the drives on your system.  If an error occurs
  602.          while saving to one drive, then you can always switch to another
  603.          drive and try again.
  604.  
  605.          CHANGE DIRECTORY:
  606.  
  607.          Many of the menus allow you to change to another directory. 
  608.          You can access all the directories available on the default 
  609.          drive.  You must be using DOS ver 2.0 or later for this to work.
  610.  
  611.          FILE NAME EXTENSIONS:
  612.  
  613.          1.  FORMS uses the file name extensions FRM and FOF to designate 
  614.          master form and completed (filled out form) respectively.  These
  615.          extensions are transparent to you except when you ask for a 
  616.          complete directory listing under the utilities menu or from DOS.
  617.  
  618.          2.  Master forms when saved to disk consist of only the text with
  619.          a 128 byte header containing information about the form size.
  620.  
  621.          3.  Completed forms when saved to disk consist of the text 
  622.          alternated with the video attribute (protected or unprotected) 
  623.          along with the 128 byte header.
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                                          7
  658.  
  659.  
  660.  
  661.  
  662.